home *** CD-ROM | disk | FTP | other *** search
/ TOS Silver 2000 / TOS Silver 2000.iso / Spiele / GEMSPIEL / COLTRIS / DOC / README.TXT < prev   
Encoding:
Text File  |  1995-04-21  |  9.7 KB  |  255 lines
  1. WinColTris  V2.0  27.12.1994
  2.             V2.2   5. 4.1995
  3.  
  4. yet another COLUMNS and TETRIS version
  5.  
  6. written by Th. Morus Walter
  7. (c) 1994/95 by Never Ready Software, Morus Walter
  8.  
  9. This program was FREEWARE!
  10. This program is FAIRWARE!
  11.   Das heißt, ich, der Autor, bitte alle, denen WinColTris gefällt und
  12.   die es öfters nutzen, um eine kleine Spende als Anerkennung meiner
  13.   Arbeit...
  14.  
  15.  
  16. Th. Morus Walter
  17. Frankenstraße 214
  18. 97078 Würzburg
  19. FEDERAL REPUBLIC of germany
  20. Kontonr.: 301116  Raiffeisenbank Rimpar-Versbach eG  BLZ 790 682 22
  21.  
  22.  - - - - -
  23.  
  24. First of all, I want to apologize for my bad english and all the mistakes
  25. I made
  26.  
  27.  - - - - -
  28.  
  29. WinColTris V2.0 is a new version of ColTris V1.0.
  30. Since there was already a tetris-program called ColTris, I decided to
  31. use a new name for my ColTris. The Win stands for window (not Windows,
  32. and not MS-Windows at all). However I will sometimes use the old name
  33. COLTRIS in this document.
  34.  
  35. When writing V1.0, I thought windows would be to much work and not very
  36. neccessory. This has changed in V2.0.
  37. The other new feature in V2.0 is the support of color-resolution. This
  38. is not quite as fast as monochrom, since WinColTris uses the VDI in
  39. color-resolutions, but I think it is fast enauge. (You should NVDI
  40. or something else to speed up things).
  41.  
  42. Preface to V1.0 (partially)
  43. ---------------------------
  44. yet another COLUMNS and TETRIS version - why?
  45.  
  46. There are a lot of columns and tetris versions, so why another one?
  47. Until now, I used PCM van der Arends COLUMNS and STETRIS. I liked these
  48. versions but they don't run with MagiX (especially not if you use
  49. AutoswitchOverscan).
  50. So I needed an alternative and couldn't find one I liked (although
  51. there were a lot of programs).
  52. Therefore I wrote my own program (using PCM van der Arends programs as
  53. a model) and here it is.
  54.  
  55. Compared to PCM van der Arends programs there are some missing features,
  56. on the other hand there are some advantages.
  57.  
  58.  - - - - -
  59.  
  60. COLTRIS should run on every ST/TT/Falcon.
  61.  
  62. WinColTris supports principially every resolution starting with 320x200 pixel
  63. and up to 256 colors (no support for high/true color).
  64. Monochrom resolutions are supported by special assembler routines, in
  65. color only the vdi is used.
  66. WinColTris contains only monochrom stones in one size. However stones
  67. of arbirary size can be loaded from image files, which is necessary in
  68. color. The stones have to have as much colors as the screen.
  69. There are stones for 4 and 16 colors in this distribution, which
  70. can be used in st-mid and st-low (see 'Sprites' below). However these are
  71. rather for example than for playing, first because I don't play in color
  72. resolutions, second because I don't have a good painting program.
  73.  
  74. COLTRIS works under MagiX (I guess also MultiTOS but I couldn't check);
  75. in the 'multi'-Mode of COLTRIS you can play without blocking the screen.
  76.  
  77.  - - - - -
  78.  
  79. I guess everyone knows columns and tetris, so I won't explain the games.
  80.  
  81.  - - - - -
  82.  
  83. COLTRIS V2.0 runs - other than V1.0 did - only as a program, since it uses
  84. a pulldown menu. You can't use it as a accessory.
  85.  
  86. WinColTris uses up to four windows, for the game itself, the scoring, the
  87. preview and a statistic.
  88.  
  89. After starting the program the main window, more windows if active and the
  90. menu is displayed.
  91.  
  92. WinColTris provides the following menu items:
  93.  
  94. menu 'WinColTris' entry 'about WinColTris':
  95. you guess it...
  96.  
  97. menu 'File':
  98.   entry 'Play'
  99.     Hmm, what might this mean.
  100.     If you reach a new hiscore, you will be ask to enter your name at
  101.     the end...
  102.   entry 'Hiscore'
  103.     show the hiscore-table of the active game
  104.     If the last result was a new hiscore, it's entry will be marked
  105.     by '*'
  106.   entry 'Save'
  107.     Save hiscore AND options
  108.     The hiscore is not save automatic.
  109.     Together with the options, the window postions are save. This is
  110.     done separate for up to 8 screen resolutions.
  111.   entry 'Quit'
  112.     lets go...
  113.  
  114. menu: 'Options':
  115.   entry 'Tetris'
  116.     set playmode to tetris
  117.   entry 'Columns'
  118.     set playmode to columns
  119.    if the playmode is changed, the main window is adjusted and the other
  120.    windows are shown according to the settings for the game, this means
  121.    you can toggle the preview on for tetris and off for columns...
  122.   entry 'Score'
  123.    toggle the score-window
  124.   entry 'Preview'
  125.    toggle the preview
  126.   entry 'Statistic'
  127.    toggle the statistic
  128.   entry 'Options'
  129.     set options
  130.     These are partially separate for columns and tetris, so you get
  131.     the tetris options if 'tetris' is selected and the columns options
  132.     if 'columns' is selected (together with the common options).
  133.     First you can select the start level for the game. Second you can
  134.     select some random preset for the game.
  135.     The rest of the options is common.
  136.     There are two graphics modes in COLTRIS. If the screen is comparable
  137.     to ST-high-res (just the organisation of the bitmap, this does not
  138.     mean that you have to have 640x400 pixels) you might use 'ST'. The blocks
  139.     are then copied to the screen directly. LineA variables are used
  140.     to get the screen width and Logbase() to get the screen adress in this mode
  141.     (COLTRIS does NOT use LineA besides this).
  142.     Otherwise use 'VDI'. The blocks are then copied to the screen by the VDI.
  143.     The VDI is slower than my assembler routines, but there should be no
  144.     flickering since there is a buffer.
  145.     In color resolutions VDI is used automaticly.
  146.     Next you can select the playmode: in the mode 'single' WinColTris takes
  147.     control over screen and mouse, so window-operations etc. are impossible,
  148.     other programs (under multitasking) can't do any output (this causes
  149.     a minor problem if you toggle the windows during game (see below).
  150.     If you switch of a window and the background is another window
  151.     this window can't be redrawn. So the window seems to stays on the screen.
  152.     If the background is the desktop the screenmanager does redraw (don't
  153.     understand that), so the problem is relevant under multitasking only...).
  154.     In the other mode ('multi') WinColTris simply tops it's windows.
  155.     Mouse- and screen-control isn't taken, so other programs can do
  156.     output, windows can be moved... This mode is slower, since the window
  157.     has been checked every output. The WinColTris' menu items can be
  158.     used partialy, however shortcuts aren't possible. The AV/VA send-key
  159.     message, which is used to send unrecognized keys to the AV/VA-server
  160.     (if there is one, e.g. gemini or ease, in multitasking), is not used.
  161.     PLEASE NOTE: even if the names of the modes sound like, you don't have
  162.     to use 'single' under single-tos and 'multi' under multitasking.
  163.     Both modi are possible unter both OS...
  164.     Next you can select the AV/VA mode, which is interesting in multitasking
  165.     if you have an good desktop like gemini or ease. You can set, which
  166.     windows WinColTris should tell the desktop, so that they participate
  167.     in the window cycling (via Ctrl-W).
  168.     The last button is to set, wether all windows or the main window only
  169.     should be raised when starting a game.
  170.     With the last option you can choose the user-defined keys. You can
  171.     define (additional) keys for the basic functions (stone left, stone
  172.     right, rotate stone and drop stone).
  173.  
  174.  - - - - -
  175.  
  176. Shortcuts:
  177. besides the shortcuts shown in the menu you have the following possibilities:
  178.  
  179. all commands apart from 'ctrl S' and 'ctrl Q' can be used without ctrl.
  180. 'return' and 'enter' start the game.
  181.  
  182.  - - - - -
  183.  
  184. While playing several keys are predefined:
  185.  
  186. 7#     stone left
  187. 9#     stone right
  188. 8#     rotate stone
  189. 4#     drop stone
  190. space  drop stone
  191. q      quit game
  192. esc    quit game
  193. s      stop game (continue with any key)
  194. l      increase level
  195. *#     increase level
  196. n      toggle preview (next)
  197. b      toggle statistics
  198. i        toggle score
  199.  
  200. The hash (#) indicates keys on the num-pad (COLTRIS uses scancodes, however
  201. there shouldn't be problems with non-german keyboards).
  202. Userdefined keys are interpreted first, so they may overwrite the predefined
  203. keys (defining a user key 'n' for example disables the toggling of the
  204. preview during the game).
  205.  
  206. If you toggle a window during game, it's old value will be restored at the
  207. end of the game.
  208.  
  209.  - - - - -
  210.  
  211. Sprites:
  212.  
  213. At first i wrote WinColTris for monochrom resolutions only. The only
  214. sprites included are for this case.
  215. In other cases (four or more colors) the sprites are loaded from
  216. IMG-files (without color-table). You can do that also in monochrom,
  217. but then WinColTris uses the VDI-mode for graphic output.
  218.  
  219. The files have the names COLUMNSx.IMG und TETRISx.IMG, where x means
  220. the number of planes (4 colors -> 2 planes, 16 colors -> 4 planes,
  221. 256 colors -> 8 planes, True/HiColor is impossible).
  222. There are separate files for columns and tetris, however you might
  223. use the same file twice (note: tetris is 10x20, columns 6x16 stones).
  224.  
  225. The stones can have any size. There is no check wether the main window
  226. fits on the screen.
  227.  
  228. The IMG-files has to contain one line with 16 sprites, where
  229.  
  230. the first one is empty (it's used to delete),
  231. the second to the eighth are the differant colors of the stones
  232.   (column does not use the last one)
  233. the nineth to thirteenth are shown as a 'film' before stones are removed
  234. the last three stones are unused (they have to be there, otherwise
  235.   the width can't be calculated correctly).
  236.  
  237. The stones don't have to be quadratic, however all stones have to
  238. have the same width.
  239.  
  240. The colortable of a XIMG-file is ignored.
  241.  
  242. The example files (equal for columns and tetris) are very ugly.
  243. They should be used to create one stones not to play (I don't use
  244. color...)
  245. The size of the examples is according to st-low and st-mid.
  246.  
  247.  - - - - -
  248.  
  249. known bugs (not everything below is really a bug):
  250.  
  251. there is almost NO error handling on reading and writing the opts file
  252. (COLTRIS.SET).
  253.  
  254.  
  255.